Skip to content

SRRCON.org site v2: GitHub Actions + enhanced dev exp with Rake tasks and tests#423

Merged
johnhrnndz merged 60 commits intomainfrom
staging
Mar 4, 2026
Merged

SRRCON.org site v2: GitHub Actions + enhanced dev exp with Rake tasks and tests#423
johnhrnndz merged 60 commits intomainfrom
staging

Conversation

@tiffehr
Copy link
Copy Markdown
Member

@tiffehr tiffehr commented Feb 26, 2026

This pull request introduces a comprehensive modernization of the project's development, testing, and deployment workflows:

  • transitions CI/CD from Travis CI to GitHub Actions
  • adds automated dependency management
  • standardizes formatting and linting across Ruby, HTML, Markdown, and YAML files
  • adds detailed documentation and configuration to support contributors and maintainers

CI/CD Modernization and Automation:

  • Migrated from Travis CI to GitHub Actions, adding workflows for deployment (deploy.yml), testing (test.yml), and weekly health checks (health-check.yml). These workflows automate build, validation, deployment to S3/CloudFront, and open issues on failures, using OIDC for AWS authentication.
  • Introduced Dependabot configuration for automated updates of GitHub Actions and Ruby gems, with labels and limits.

Development Environment and Tooling:

  • Added and configured Prettier (.prettierrc, .prettierignore), StandardRB (.standard.yml), and VSCode workspace settings (.vscode/settings.json) to enforce consistent formatting and linting for Ruby, HTML, Markdown, and YAML files.
  • Updated Gemfile to include Jekyll, plugins, build tools, and test/lint dependencies.

Project Documentation and Contributor Guidance:

  • Added a detailed Copilot instructions document (.github/copilot-instructions.md) outlining project architecture, workflows, conventions, validation, deployment, and editing guidance for contributors and automation agents. ([.github/copilot-instructions.mdR1-R55](https://github.com/OpenNews/srccon/pull/423/files#diff-227c2c26cb2ee0ce0f46a320fc48fbcbdf21801a57f59161b1d0861e8aad55f5R1-R55))

These updates collectively improve project maintainability, contributor onboarding, and deployment reliability, while ensuring code quality and consistency.

[AI written summary]

tiffehr and others added 30 commits February 3, 2026 18:26
also gitignore a temp/ dir for local storage of prompts and notes, etc
…om site-starterkit work

- Created TROUBLESHOOTING.md for common issues and solutions in site development.
- Updated _config.yml to improve site configuration and defaults.
- Added package.json and package-lock.json for Prettier integration.
- Created tasks/README.md to document available Rake tasks.
- Implemented format.rake for code formatting and linting tasks.
- Enhanced outdated.rake for better dependency management.
- Improved test.rake with comprehensive site validation tests.
Mostly in static `/ _archive/*` files; some replacement of dead links with hard-coded varieties
- this lets us drop the `redirect_to` Gem pattern here
- where possible, corrected URLs to absolute or other replacement paths in older files
- enhance footer and navigation with updated sponsor links and improved accessibility information
- better maintainability across both `layout` rendering paths
Briing over latest copy to the root SRCCON site along with revised credits at the bottom
initial AI-driven "upgrade" was fairly poor, this catchs things up to the starterkit and 2026 standards
…templates`

HTML corrections on odd files and the `_share/` directory
expanded range into the `_archive/` files for a one-time tune up of whitespace and other inoffensive "errors"
Co-authored-by: tiffehr <60173+tiffehr@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
fix: restore hub_footer tagline visibility on main_footer pages
Upgrades from Travis to modern dev approaches + GitHub Actions
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.19.0 to 1.19.1.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md)
- [Commits](sparklemotion/nokogiri@v1.19.0...v1.19.1)

---
updated-dependencies:
- dependency-name: nokogiri
  dependency-version: 1.19.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
@tiffehr tiffehr self-assigned this Feb 26, 2026
@tiffehr tiffehr marked this pull request as ready for review February 26, 2026 00:53
@tiffehr tiffehr changed the title Enhance developer experience with Rake tasks, cleanup, and updates SRRCON.org site v2: GitHub Actions + enhanced dev exp with Rake tasks and tests Feb 26, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR modernizes the SRCCON Jekyll site’s developer workflow by introducing new Rake tasks, formatting/linting tooling, and a GitHub Actions-based CI/deploy pipeline, alongside broad content cleanup (link/HTTPS updates, layout/include refactors, and archive formatting normalization).

Changes:

  • Added developer tooling: StandardRB + Prettier configuration, Node package setup, and Rake tasks for lint/format and dependency checks.
  • Migrated CI/CD from Travis to GitHub Actions with workflows for testing, deployment to S3/CloudFront, and weekly health checks.
  • Refactored layout metadata handling (new headmeta include) and updated many pages/templates for link hygiene and formatting consistency.

Reviewed changes

Copilot reviewed 141 out of 273 changed files in this pull request and generated no comments.

Show a summary per file
File Description
.github/workflows/test.yml Adds CI test workflow (YAML validation, Jekyll build, html-proofer, optional AWS dry-run).
.github/workflows/deploy.yml Adds branch-based deploy to S3 with optional CloudFront invalidation using OIDC.
.github/workflows/health-check.yml Adds scheduled weekly build/dependency health check and issue creation on failure.
.github/dependabot.yml Adds Dependabot config for Actions and Bundler updates.
.travis.yml Removes Travis CI configuration.
tasks/format.rake Introduces rake lint/rake format and StandardRB/Prettier task wrappers.
tasks/outdated.rake Adds Rake tasks for bundle outdated checks (direct vs transitive).
tasks/README.md Documents available Rake tasks and intended usage.
package.json / package-lock.json Adds Node toolchain for Prettier (+ Ruby plugin) formatting scripts.
.prettierrc / .prettierignore Adds Prettier configuration and ignore rules.
.standard.yml Adds StandardRB configuration and ignore list.
.ruby-version Pins Ruby version for local/CI consistency.
Gemfile Defines Ruby dependencies for Jekyll, Rake, StandardRB, and html-proofer.
_config.yml Adds deployment config values and defaults (incl. latest_srccon_program, GA toggle).
_layouts/layout_hub.html Refactors hub layout structure and centralizes head metadata via include.
_includes/headmeta.html Adds shared <head> metadata and optional GA4 snippet.
_includes/live_sessions_table.html Updates schedule/program links to use page.latest_srccon_program.
_includes/srccon_heart_2020_footer.html Footer markup cleanup + updated social/support links.
_includes/srccon_care_2022_footer.html Footer markup cleanup + updated social/support links.
_includes/navigation.html / _includes/hub_footer.html / _includes/footer.html Removes older include partials (replaced by refactors).
homepage.md, conduct.md, heart-2020*.md, care-2022-*.md, _share/*.md, _transcripts/*.md, _archive/**/* Broad formatting normalization and link updates (notably HTTPS upgrades and content cleanup).
_config/staging/s3_website.yml, _config/production/s3_website.yml Removes legacy s3_website deploy configuration files.
.vscode/settings.json Adds VS Code workspace formatting/linting defaults and exclusions.
tasks/paths.txt Adds a path list file intended for review/compare tooling.

This comment was marked as resolved.

@github-advanced-security

This comment was marked as resolved.

@johnhrnndz johnhrnndz merged commit 99be5fe into main Mar 4, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants